Play command syntax

Play commands are used to define the music file that will be played in background when an album or a picture is displayed.

Play commands can be attached to a single picture or to an album:

• Album level: the command is played when a slideshow is started (not when viewing individual pictures).
• Picture level: the command is played when the corresponding picture is displayed.

The general format of a play command is (caution, no spaces before or after the vertical bars!):

Basic syntax (one line):
    type|file|flags|parameters

Extended syntax (several lines):
    type|file|-|parameters
    type|file|-|parameters
    type|file|-|parameters
    ...
    *flags        (optional)

With:

type	One of the following keyword
	wav	Audio file (*.wav).
	mid	Midi file (*.mid or *.rmi).
	cda	CD Audio.
	script	Script file (*.vbs or *.js).
	media	Windows Media Player file (*.wav, *.mp3, *.mpg,...).
	fpxr	Embedded sound in a JPEG file (FlashPix extension in a APP2 marker).
	sync	Wait for previously started sound(s) to end (picture level only).
file	The file containing the media to play (this pathname must not include spaces for wav and mid types)
flags	One or more of the following uppercase characters:
	C	Continuous play (picture music only): do not stop when the displayed picture changes.
	R	Repeat (play in loop).
	W	Slideshow: wait for the music to stop before going to the next picture.
	S	Slideshow: stop all playing sounds before playing this one.
	V	Script: display script console.
	I	Immediate: play before displaying the picture.
parameters	Device dependent parameters

Some fields are optional and can be omitted. Empty fields are represented by the '-' character.

Examples:

wav|D:\TMP\Thunder.wav
    Plays the specified audio file.

mid|D:\Musique\021.MID|CR

cda|-|-|from 2 to 3
    Play track 2 and 3 from the current CD Audio (note the two empty '-' fields).

script|msgBox "MyAlbum is good for you !"|-|2
    Run the VBScript (2) code without showing the script console. The script shows a simple message box.
    Use the following values for the parameters field: 1: script file, 2: VBScript code, 3: JavaScript code (and 100+i for installed script engine #I).

script|App.GetFullScreenView.ModifySlideShowMode SS_AUTO, False|-|2
media|somemusicfile.mp3
*C
    Run the VBScript (2) code to pause the slideshow and start playing the music. This can be used with a HTML index page waiting for a user selection.

media|C:\MP3 Music\Bob\Burnin' and Lootin'.mp3
    Plays the specified mp3 file using Windows Media Player.

fpxr
    Plays the embedded wav file.